home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / CONVERTR / MHONARC / DESC.TXT next >
Encoding:
Text File  |  1995-09-11  |  4.8 KB  |  145 lines
  1. ---------------------------------------------------------------------------
  2.  
  3. [Image]MHonArc
  4.  
  5. An E-mail-to-HTML converter
  6.  
  7. ---------------------------------------------------------------------------
  8.  
  9. Contents
  10.  
  11.    * What's New
  12.    * What is MHonArc?
  13.    * Why Use MHonArc?
  14.    * Examples
  15.    * Availability
  16.    * More Information
  17.    * Open bugs
  18.    * Extras
  19.  
  20. ---------------------------------------------------------------------------
  21.  
  22. What's New
  23.  
  24. What's New last Updated: Thu Apr 20 15:59:16 PDT 1995
  25.  
  26. MHonArc 1.1 is now available. New features include:
  27.  
  28.    *  Run on Unix or MS-DOS platforms
  29.    *  Thread index
  30.    *  Remove messages from an archive
  31.    *  List contents of archive to standard out
  32.    *  Restrict size of an archive
  33.    *  Detection of already archive messages during add operation
  34.    *  More customization features
  35.    *  Added more variables for use in user defined mailto URLs
  36.    *  Bug fixes
  37.  
  38. ---------------------------------------------------------------------------
  39.  
  40. What is MHonArc?
  41.  
  42. MHonArc is the successor of mail2html, a Perl mail-to-HTML converter.
  43. MHonArc works in a very simliar manner as mail2html (HTML mail archiving
  44. with index, mail thread linking, etc), but with much more capabilities
  45. including full support for MIME, as defined in RFC 1521, and powerful user
  46. customization features..
  47.  
  48. ---------------------------------------------------------------------------
  49.  
  50. Why Use MHonArc?
  51.  
  52. Here are some reasons for using MHonArc:
  53.  
  54.    * You want to keep organized archives of mail messages and/or news
  55.      articles for a World Wide Web (WWW) server; complete with live
  56.      hypertext pointers to their authors and to any url's mentioned.
  57.    * You would like to control the layout of mail/news archives to keep a
  58.      consistent style to your WWW pages.
  59.    * You have a WWW client, but no MIME mail reader. MHonArc will allow you
  60.      to read MIME messages that includes images, audio, video, etc via your
  61.      Web client.
  62.    * Muli-platform support: MS-DOS and Unix.
  63.    * You think the MHonArc logo is really cool, and it deserves to be used.
  64.    * You like Perl, and you want to see what it can do.
  65.    * Just cuz.
  66.  
  67. ---------------------------------------------------------------------------
  68.  
  69. Examples
  70.  
  71. To see the type of output generated by MHonArc, check out the sample
  72. archive of some newsgroup posts from comp.infosystems.www.authoring.cgi.
  73.  
  74. MIME
  75.  
  76. MHonArc can handle MIME encoded messages. See an example MIME message
  77. processed.
  78.  
  79. ---------------------------------------------------------------------------
  80.  
  81. Availability
  82.  
  83. Unix
  84.      The latest version of MHonArc is 1.1. You can get MHonArc in
  85.      tar-gzipped file via HTTP or FTP (199889 bytes).
  86.  
  87. MS-DOS
  88.      MHonArc for MS-DOS is available in a ZIP file via HTTP or FTP (244002
  89.      bytes)
  90.  
  91.      Special Note for MS-DOS users:
  92.         o IMPORTANT: You must preserve the subdirectory structure of the
  93.           .zip archive when unzipping MHonArc. Use the -d option if you are
  94.           using pkunzip.
  95.  
  96. ---------------------------------------------------------------------------
  97.  
  98. More Information
  99.  
  100. To get the complete lo-down on MHonArc, read the documentation that is
  101. included in the distribution.
  102.  
  103. ---------------------------------------------------------------------------
  104.  
  105. Open Bugs
  106.  
  107. Bug list last updated: Thu Aug 17 13:53:28 PDT 1995
  108.  
  109. List of open bugs for version 1.1:
  110.  
  111.    * The month is off by -1 of the real month in the -scan output.
  112.  
  113.    * The following example invocations are incorrect in the Synopsis
  114.      section of the Overview:
  115.  
  116.      % mhonarc -add [options] < mhfolder ...
  117.      % mhonarc -add -mbox [options] < mailbox
  118.  
  119.      The previous will not work, and may cause unexpected results.
  120.  
  121.    * Message IDs with single quotes causes the .mhonarc.db to contain
  122.      illegal Perl code, leading to subsequent add operations to fail.
  123.      Basically, the single quotes are not escaped properly for keys of an
  124.      associative array.
  125.  
  126.    * Spaces are not escaped properly when custom mailto URL is defined.
  127.  
  128. ---------------------------------------------------------------------------
  129.  
  130. Extras
  131.  
  132. HtmlMail
  133.      Program to pipe a mail/news message to a WWW client. See comments at
  134.      beginning of source file on how to use it.
  135.  
  136. MosaicMail
  137.      A Perl program to load in a mail message into an existing Mosaic for X
  138.      session. MHonArc is called to do the actual mail-to-HTML conversion.
  139.      MosaicMail can also be used to pipe newsgroup posts into Mosaic from
  140.      your newsreader. Handy for making URLs hyperlinked, or processing MIME
  141.      posts.
  142.  
  143. ---------------------------------------------------------------------------
  144. Earl Hood <ehood@convex.com>
  145.